home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / eumal610.zip / BRUCE610.DOC next >
Text File  |  1996-10-30  |  23KB  |  444 lines
  1. BRUCE610.DOC                         1                         Revised: 10-30-96
  2.  
  3. --------------------------------------------------------------------------------
  4.                               Contact information
  5.  
  6. For the following routines:  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  7. EUMAIL, FILL, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE,  READINIT,  READMAKE-created
  8. files, and TXTABLE:
  9.  
  10.                 Bruce Guthrie
  11.                 Wayne Software
  12.                 113 Sheffield St.
  13.                 Silver Spring, MD 20910
  14.  
  15.                 fax: (301) 588-8986
  16.                 e-mail: bguthrie@nmaa.org
  17.                 http://hjs.geol.uib.no/guthrie/
  18.  
  19. For the following routines:  CHANGE, CONVERT, FILUPDAT, READ, and READY:
  20.  
  21.                 Bruce Guthrie
  22.                 Room H-4885
  23.                 U.S. Dept of Commerce/ESA/STAT-USA
  24.                 Washington, DC 20230
  25.  
  26.                 fax: (202) 482-2164
  27.                 voice: (202) 482-3234
  28.                 e-mail: bguthrie@doc.gov
  29.  
  30. Please provide an Internet e-mail address on all correspondence.
  31.  
  32. Since these programs are typically "freeware"  (with  the  exception  of  people
  33. trying to make money from them instead of me), they generate maybe $100/year  in
  34. revenue for me.  As such, my ability to afford  wonderful  customer  support  is
  35. somewhat restricted.   Please  do  not  leave  messages  saying  "Call  me  long
  36. distance".  Also, please be specific  about  what  problems  you  encounter  and
  37. include command-line inputs as well as any control  or  INI  files  that  you're
  38. using.
  39.  
  40. WIN/NT AND WIN95 USERS:  All of these programs are DOS applications.  This means
  41. that they expect 8.3 filenames, short paths, etc.  If  you  use  long  paths  or
  42. illegal characters in your file names or whatever, these programs may  not  work
  43. for you.  This is not a "bug" in the software.  That's just  the  way  DOS  apps
  44. are.
  45.  
  46. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  47. to this software, whether express or implied, including without  limitation  any
  48. implied  warranties  of  merchantability,  fitness  for  a  particular  purpose,
  49. functionality, data integrity or protection.
  50.  
  51.  
  52. BRUCE610.DOC                         2                         Revised: 10-30-96
  53.  
  54. --------------------------------------------------------------------------------
  55.                                   Introduction
  56.  
  57. This documentation provides some overview information on a number of  utilities.
  58. All  programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  59. distributed with a Wayne Software copyright.  Others were written for  the  U.S.
  60. Department of Commerce.  All are free for use provided relevant documentation is
  61. kept with the programs, no changes are made to the  programs  or  documentation,
  62. and they are not bundled with commercial programs or charged for separately.
  63.  
  64. CHANGE,  CONVERT,  FILUPDAT,   READ,   and   READY   are   excluded   from   the
  65. commercial-packaging  restriction.   These  programs  are  owned  by  the   U.S.
  66. Department of Commerce and may be re-distributed without restriction.
  67.  
  68. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, EUMAIL,
  69. FILL, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE, READINIT, or TXTABLE  in  commercial
  70. packages other than shareware/freeware collections must pay a  $50  registration
  71. fee to "Wayne Software" at the following address.   READMAKE-created  files  are
  72. also subject to this limitation.  I don't expect to make any  money  from  these
  73. utilities but I don't want others to sell them instead.
  74.  
  75. This collection of utilities were compiled using Microsoft's  Visual  BASIC  for
  76. DOS 1.0 compiler.  Thomas G. Hanlin III's excellent  PBClone  routines,  release
  77. 2.3, provided additional functionality.  Since Tom has dropped support  for  his
  78. PBClone routines, some things will are simply not possible for me to do so don't
  79. push!  The basic routines should be able to be maintained indefinitely  as  long
  80. as DOS continues to exist; we'll see.  Keep in  mind  that  they  are  DOS-based
  81. routines so forget long Win95 file names and  such.   I  keep  thinking  that  I
  82. should be doing Windows programming but it's hard to get  psyched  up  for  that
  83. when you think of Windows as a computer virus.
  84.  
  85. Documentation provided in appropriate ZIP files:
  86.  * routine.DOC: Each utility is separately described in a like-named *.DOC file.
  87.  * FILE_ID.DIZ: Standard Description In Zip file.
  88.  * BRUCEymm.DOC: This file serves to summarize all  of  the  various  utilities.
  89.      The "ymm" indicates the release date in  year/month  format.   "601"  means
  90.      1996, first month (Jan 1996).
  91.  * BRUCEINI.DOC: Most of the routines have defaults that can  altered  by  using
  92.      initialization files (inifiles).   These  are  referenced  in  the  regular
  93.      documentation and further described here.  (One thing about *.INI files; if
  94.      you don't have one, it's in your interests to specify the "/-I"  parameter.
  95.      Otherwise, the program searches your entire DOS path looking for the file.)
  96.  * BRUCEHEX.DOC: Many of the routines allow you to enter  parameters  as  either
  97.      hexadecimal  or  decimal  strings.   This  is  referenced  in  the  regular
  98.      documentation and further described here.
  99.  
  100.      All program documentation was created  using  a  text  editor  (PE2).   The
  101.      PAGINATE command (see below) was  used  to  justify  the  text  and  create
  102.      titles, page breaks, and (where provided) indexes.
  103.  
  104. Beta  testers  and  suggestions  are  always   appreciated.    Contact   me   at
  105. bguthrie@nmaa.org  Note that all beta releases are done via e-mail  so  if  your
  106. gateway can't handle some pretty big mail attachments,  you  definitely  do  NOT
  107. want to be a beta tester for me!  Modifications that are not of  mainstream  use
  108. can be contracted for.
  109.  
  110.  
  111. BRUCE610.DOC                         3                         Revised: 10-30-96
  112.  
  113. --------------------------------------------------------------------------------
  114.           Finding the programs--Current version is 610 (1996 October)
  115.  
  116. The utilities are uploaded with a ZIP name that includes the year and  month  of
  117. the release in a "ymm" format (mm-number month where 01=January,  and  199y  for
  118. year).  The files are  posted  directly  by  the  author  to  two  places.   The
  119. following Web site, provided by Hans Schrader, has the current versions of *all*
  120. programs:
  121.  
  122.                 http://hjs.geol.uib.no/guthrie/
  123.  
  124. Major revisions are directly posted by the author to the following:
  125. * Simtel (Coast-To-Coast): ftp.coast.net (http://www.coast.net/Simtel)
  126. * Simtel (Keith Petersen): ftp.simtel.net (http://www.simtel.net/simtel.net)
  127. * ZDI Software Library:  No idea where that is!
  128.  
  129.                          Simtel locations and versions
  130.  
  131. http://www.coast.net/SimTel/msdos/      ftp://ftp.simtel.net/simtelnet/msdos/
  132.   ..arcutil/                            ..arcutils/
  133. av607.zip       Archive View: Free ZIP etc directory viewer
  134.   ..batutil/                            ..batchutl/
  135. dates610.zip    Warns you in advance of birthdays etc
  136. fortn608.zip    Fine-tunes DOS FOR command w/options
  137.   ..dirutil/                            ..dirutl/
  138. cops608.zip     Copies files modified since given date
  139. dirco609.zip    Updates files based on source directory
  140. dirto610.zip    Directory lister and totaller
  141. filup610.zip    Copy updated files based on a control list
  142.   ..diskutil/                           ..diskutil/
  143. fill610.zip     Stuffs as many files as possible on disk
  144.   ..offline/                            ..mailnews/
  145. eumal610.zip    Eudora utility for nicknames, boxes
  146.   ..spredsht/                           ..spredsht/
  147. convr609.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  148.   ..textutil/                           ..txtutl/
  149. bfind610.zip    Boolean FIND command (BFIND BEGIN & END)
  150. chang610.zip    Change strings in text/binary files
  151. fixtx607.zip    Translate text file characters en masse
  152. htmst610.zip    Reprocesses HTML pages for humans to read
  153. pagin607.zip    Paginates text (indexes, sorts, tables)
  154. read609.zip     Free viewer, also make any text self-viewing
  155. txtab607.zip    Generates text tables
  156.  
  157. If you're using a version of the programs that's more  than  a  year  old,  it's
  158. almost always the case that there's  a  newer  version.   Please  check  for  an
  159. update.  If you can receive binary attachments, contact me at  bguthrie@nmaa.org
  160. for free updates.  Alternatively, send $10 made out to "Wayne Software"  to  the
  161. Wayne Software address above and I'll send you everything on diskette.  (If  you
  162. need anything other than 3.5" high density, specify that too please.)
  163.  
  164. The versions of each program posted on SimTel are documented  below  along  with
  165. the directory information for  this  site.   The  *current*  versions  of  *all*
  166. programs are posted on the Web site in Norway.
  167.  
  168.  
  169. BRUCE610.DOC                         4                         Revised: 10-30-96
  170.  
  171. --------------------------------------------------------------------------------
  172.                            Short program descriptions
  173.  
  174.    AV.EXE:  Archive directory viewer.  Presents list of files in  archive  (ZIP,
  175.    ARC, etc) and lets you sort as desired.  Also allows resetting  of  the  file
  176.    date based on the archive's contents.
  177.  
  178.    BFIND.EXE:  Allows Boolean-type FIND requests.  For example,  find  any  line
  179.    with one string AND another one, or any line  with  one  string  OR  another.
  180.    Also allows wildcarded input file names.
  181.  
  182.    CHANGE.EXE:  Processes change commands in files.  Files can be  of  any  size
  183.    and type (e.g. binary or text) and  are  processed  quickly.   Up  to  thirty
  184.    change commands can be processed in a single pass.  Also provides ability  to
  185.    remove trailing spaces from text files.
  186.  
  187.    CONVERT.EXE:  Converts between data  formats:   FROM  dBase,  ASCII-delimited
  188.    (typically commas between fields and quotes around strings), and fixed  field
  189.    TO Lotus WKS, ASCII-delimited, dBase, and fixed field.
  190.  
  191.    COPSINCE.EXE:  Copies all files modified since a given date.  Primarily  used
  192.    for making sure you have a back-up of files and also to copy updated programs
  193.    to another place.  Lets you define your own groupings of files if desired.
  194.  
  195.    DATES.EXE:  Program that warns you in advance when an event like a  birthday,
  196.    anniversary, or holiday is coming up.   The  idea  is  to  give  you  advance
  197.    warning so you can send a card or get out of town in time.
  198.  
  199.    DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds  ability
  200.    to delete extra files in the destination subdirectory, copy hidden and system
  201.    files, and prepare a report showing inconsistencies.  Is frequently  used  by
  202.    network administrators to update workstation files.
  203.  
  204.    DIRTOTAL.EXE:  Prepares  report  showing  files  in  subdirectory  or  drive.
  205.    Allows restricting search based on date, size,  attributes,  etc.   Works  on
  206.    networked and CD-ROM drives.   Produces  more  formalized  report  than  some
  207.    utilities do.  Also allows you to look for duplicate file names.
  208.  
  209.    EUMAIL.EXE:  Eudora mail summarizer.  Dumps your Qualcomm Eudora mailbook  as
  210.    well as summarizing the contents of all of your Eudora boxes and folders.
  211.  
  212.    FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  213.    biggest files first and skipping those that won't fit.  Also provides  option
  214.    of splitting large files, creating a status report, and other features.
  215.  
  216.    FILUPDAT.EXE:  Program which compares a selected list of files  in  a  source
  217.    path against those in another path and copies those that have  been  updated.
  218.    Similar to DOS' REPLACE command  but  works  from  a  stored  list  of  files
  219.    (controlled updates) and can handle any number of directories.
  220.  
  221.    FIXTEXT.EXE:  Program which applies  a  user-definable  character-translation
  222.    table to a text file.  Can allow you to convert graphics characters to  their
  223.    text equivalents, lowercase letters to uppercase letter, etc.   Can  also  be
  224.    used to translate DOS text files to Mac or Unix text files  and  vice  versa.
  225.    Can also expand tabs, remove trailing spaces, and remove backspaces.
  226.  
  227.  
  228. BRUCE610.DOC                         5                         Revised: 10-30-96
  229.  
  230.    FORTUNE.EXE:  A tuner-upper for the DOS FOR command.  Generates a batch  file
  231.    which does all those wildcard things you wished FOR could do  (like  "FORTUNE
  232.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets  you  do
  233.    all sorts of things including  distinguishing  file  name  roots  from  their
  234.    extensions as well as incrementing file names by specified values.
  235.  
  236.    HTMSTRIP.EXE:  Goes  through  downloaded  pages  from  the  Web  and  removes
  237.    embedded HTML commands.  Reflows paragraphs and tries to  make  it  basically
  238.    readable. Can function on  individually-saved  pages  or  else  process  your
  239.    entire disk cache. Awarded a "Best" rating by "PC Computing"  in  their  July
  240.    1996 issue.  Includes MOZ.EXE which renames  the  files  in  your  Web  cache
  241.    subdirectory so you can identify them more easily.
  242.  
  243.    PAGINATE.EXE:  Reformats text files with embedded formatting codes.   Handles
  244.    things like titles, footers, indexes, alignment,  justification,  multicolumn
  245.    listings,  etc.   Also  provides  support  for  embedding  tabular  data   in
  246.    ASCII-delimited or dBase formats which can be embedded and/or sorted in  your
  247.    reports.
  248.  
  249.    READ.EXE, READY.EXE, READINIT.EXE,  and  READMAKE.EXE:   Text  file  browsing
  250.    utilities.  READ--Supports marking, copying text, reading Unix and  Mac  text
  251.    files, etc.  Handles files of 16,000 lines or less  (approx  800,000  bytes).
  252.    READY--truncates or wraps lines over 255 characters  in  length  but  handles
  253.    files of an unlimited number of lines.  READMAKE--Takes  an  ASCII-text  file
  254.    and makes it self-viewable (using a READ clone).
  255.  
  256.    TXTABLE.EXE:   Program  to  generate  text  tables.   Allows  inputs  to   be
  257.    HTML-based as well as one-record per cell.
  258.  
  259.  
  260. BRUCE610.DOC                         6                         Revised: 10-30-96
  261.  
  262. --------------------------------------------------------------------------------
  263.                                 Revision history
  264.  
  265. Detailed revision histories for the programs are only maintained  for  the  last
  266. three releases.  After that, you get the major revision summaries only  for  the
  267. next three releases or so.  In any  case,  if  your  version  of  any  of  these
  268. programs is more than a year old, your version is definitely obsolete.  Hop onto
  269. the Web or e-mail me or something and get the new version!
  270.  
  271. -------------- (full detail; revisions made 1 to 3 releases ago)
  272. Release 96/10:
  273.  
  274.   All routines:  /inull (in lowercase) didn't used to work...  Sigh.
  275.  
  276.   All routines:  If you pass in /DEBUG, among other  things  the  programs  will
  277.   show you the return code before ending.
  278.  
  279.   BFIND:  Added /W, /W0, and /-W parameters, mainly to  determine  pausing  when
  280.   run run under Windows.  Should no longer fail on some truly ugly files with no
  281.   CR/LF's anywhere.  [Replaces bfind609.zip]
  282.  
  283.   CHANGE:  Added /W, /W0, and /-W parameters, mainly to determine  pausing  when
  284.   run run under Windows.  [Replaces chang609.zip]
  285.  
  286.   DATES:  The program now  defaults  to  pausing  if  being  run  from  Windows.
  287.   [Replaces dates609.zip]
  288.  
  289.   DIRTOTAL:  Added /TREE, /A, and /TOP=n  parameters.   Sorting  by  date  (/OD)
  290.   didn't work; fixed.  [Replaces dirto609.zip]
  291.  
  292.   EUMAIL:  Documentation now includes lots of  information  about  country  date
  293.   formats and such.  Pass in /DEBUG and the program will  do  more  checking  of
  294.   dates used.  Having said all of this, added a /SHOWINT parameter (which is the
  295.   default) that uses the internal date/time stamps instead of the ones shown  in
  296.   the menus so errors should not  happen  at  all.   Added  subtotals  for  each
  297.   folder. Added "% of msgs" column in summary as well.  Fixed error with  /SPLIT
  298.   when  files  were  in  a  folder.   Added  /HEAD=xxxx  parameter.    [Replaces
  299.   eumal607.zip]
  300.  
  301.   FILL:  Added attribute selections (/ATTR=x) and no longer has problems dealing
  302.   with read-only files when it moves them.  [Replaces fill609.zip]
  303.  
  304.   FILUPDAT:  Fixed error with /FULL parameter.  [Replaces filup607.zip]
  305.  
  306.   HTMSTRIP:  Documented the return codes used.  Fixed  some  alignment  problems
  307.   using /BORDER=N.  [Replaces htmst609.zip]
  308.  
  309. Release 96/09:
  310.  
  311.   BFIND:  Fixed a bug with "BFIND NOT string" searches.  [Replaces bfind607.zip]
  312.  
  313.   CHANGE:  Fixed a bug where it would repeat processing  of  some  files.   This
  314.   created some very flaky results and made  the  return  codes  worthless.   Now
  315.   forcing /BINARY mode if you include a /FROM with CR or LF in it.  /V  and  /-V
  316.   options did not work anymore; fixed them.  Fixed a bug with "/IN  NOT  string"
  317.   conditions not working.  [Replaces chang608.zip]
  318.  
  319.   CONVERT:  Fixed up a bug related  to  floating-point  fields  in  dBase  input
  320.  
  321. BRUCE610.DOC                         7                         Revised: 10-30-96
  322.  
  323.   files.  Added /Qn parameter to control frequency  of  record-by-record  status
  324.   messages.  [Replaces convr607.zip]
  325.  
  326.   DATES:  Fixed a bug with  respect  to  flashing  foreground  characters.   New
  327.   /ODATE=format parameter allows the dates to  be  displayed  in  a  variety  of
  328.   formats.  Program now requires a  single  character  delimiter  in  the  input
  329.   dates;  it  probably  did  anyway  but  documentation   specified   otherwise.
  330.   [Replaces dates607.zip]
  331.  
  332.   DIRCOMP:  Added ERRORLEVEL 249  for  /UPDATE  specified  but  nothing  copied,
  333.   moved, or deleted.   Fixed  some  bugs  in  deleting  empty  files  and  empty
  334.   subdirectories.  No longer blows up when it encounters  an  invalid  date/time
  335.   stamp for the files.  [Replaces dirco608.zip]
  336.  
  337.   DIRTOTAL:  Program would abort if a file had an invalid time  stamp.   Program
  338.   ignored /D (date) range tests; fixed.  None of  the  reverse  sorting  options
  339.   (e.g. /O-S) worked; fixed.  [Replaces dirto607.zip]
  340.  
  341.   FILL:  Program ceases to blow up when it encounters read-only files  that  you
  342.   want to "move".  [Replaces fill608.zip]
  343.  
  344.   HTMSTRIP:  Changed /-SPACES so it also removes blank columns and  (most)  rows
  345.   in tables as well as blank lines within tables.  Added "/" and "*" to the list
  346.   of characters that are acceptable as numbers when  the  program's  determining
  347.   this for cell-alignment purposes.  Fixed up some problems with translating the
  348.   "&" string.  Added support for <BASE HREF="site"> HTML command.  [Replaces
  349.   htmst608.zip]
  350.  
  351.   MOZ (included in HTMSTymm.ZIP file):  Now adds a number of fail-safe  options,
  352.   usually requiring parameters to be passed in before renaming everything in the
  353.   cache.  Includes an option to create a graphic view page  which,  when  loaded
  354.   from your Web browser, displays all graphics in your cache  and  includes  the
  355.   links for where they came form.  [Replaces htmst608.zip]
  356.  
  357.   READ, READY, READINIT:  Allowed for blinking foreground colors (which I hate).
  358.   Documentation already said they were supported but  they  weren't.   [Replaces
  359.   read607.zip]
  360.  
  361. Release 96/08:
  362.  
  363.   For some reason, several people chose this month to tell me that  my  programs
  364.   had "bugs" in them because they were  using  long  file  and  pathnames  under
  365.   Windows NT and the programs weren't handling them.  All of these programs  are
  366.   DOS applications; they don't recognize anything other than short pathnames and
  367.   8.3 file names with valid DOS characters in the file names.  If  you  want  to
  368.   branch out (literally) and use non-compatible names and structures, feel free.
  369.   However, you give up the ability the use some DOS  programs  including  things
  370.   like DIRTOTAL and DIRCOMP.  That's just  the  way  it  is.   I  can't  provide
  371.   support if you violate these rules.  These programs are freeware and it's  not
  372.   worth my time (relearning) and expense (new compilers, new program  libraries)
  373.   to rewrite them from scratch.  Sheesh!
  374.  
  375.   CHANGE:  Fixed up some bugs involving the program not putting  you  into  text
  376.   mode all the time.  More bugs fixed related to column positions and /IN string
  377.   specifications.  [Replaces chang607.zip]
  378.  
  379.   COPSINCE:  Fixed a bug handling international date formats.  Added support for
  380.   4DOS.  [Replaces cops607.zip]
  381.  
  382. BRUCE610.DOC                         8                         Revised: 10-30-96
  383.  
  384.  
  385.   DIRCOMP:  Switched /R and /-R to /U and /-U (conflicted with other  parms  and
  386.   didn't match DOS REPLACE command switches).  Added the ability to  specify  up
  387.   to 10 inclusion filespecs.  Finally added the ability  to  remove  destination
  388.   subdirectories that are now empty.  [Replaces dirco607.zip]
  389.  
  390.   FILL:  Fixed a bug related to moving files in  the  non-default  subdirectory.
  391.   [Replaces fill607.zip]
  392.  
  393.   FORTUNE:   Switched  default  to  /WIPE  (eliminate  output  batch  file  upon
  394.   completion).  [Replaces fortn607.zip]
  395.  
  396.   HTMSTRIP:  More work on debugging tables.  Added /INDENT and /-INDENT parms to
  397.   allow <BLOCKQUOTE>...</BLOCKQUOTE> blocks to be turned  off.   More  debugging
  398.   for mostly foreign pages.  [Replaces htmst607.zip]
  399.  
  400. -------------- (kind of terse; revisions made 4 to 6 releases ago)
  401. Release 96/07:
  402.  
  403.   AV, DIRCOMP, DIRTOTAL, and EUMAIL:  Added support non-US date formats (program
  404.   reads the system configuration settings).
  405.  
  406.   AV:  Now prompts for infile spec if not provided.
  407.  
  408.   BFIND and CHANGE:  Added column ranges (vs column start requirement)  for  the
  409.   search parameter.
  410.  
  411.   EUMAIL:  Added /FORMAT=n handling.
  412.  
  413.   FILL:  Changed the default to /COPY if no parameters are passed in, and  /MOVE
  414.   if any are.
  415.  
  416.   FORTUNE:  Added /RUN and /PROMPT parameters.
  417.  
  418.   HTMSTRIP:  Heady times after an endorsement from PC Computing  in  their  July
  419.   and August 1996 issues!  Improved recovery for huge cells.  Added MOZ  program
  420.   to the ZIP file.
  421.  
  422. Release 96/05:
  423.  
  424.   AV:  Added ability to delete the archive.
  425.  
  426.   CONVERT:  Program skipped the first record in DBF files; fixed this.
  427.  
  428.   DATES:  Added the ability to do weekly reminders.
  429.  
  430.   EUMAIL:  Added /SPLIT and /SCAN options.
  431.  
  432.   HTMSTRIP:  Added /A=spec, /IMG=spec, and /IMGALT=spec parameters.
  433.  
  434. Release 96/04:
  435.  
  436.   FORTUNE:  Added /WIPE parameter.
  437.  
  438.   HTMSTRIP:  Added /ALT parameter.
  439.  
  440.   ISAMMAKE/ISAMFIND:  Dropped.
  441.  
  442.  
  443. 
  444.